@aws-cdk/aws-route53

AWS Route53 Constuct Library

To add a public hosted zone:

import route53 = require('@aws-cdk/aws-route53');

new route53.PublicHostedZone(this, 'HostedZone', {
    zoneName: 'fully.qualified.domain.com'
});

To add a private hosted zone, use PrivateHostedZone. Note that enableDnsHostnames and enableDnsSupport must have been enabled for the VPC you're configuring for private hosted zones.

import ec2 = require('@aws-cdk/aws-ec2');
import route53 = require('@aws-cdk/aws-route53');

const vpc = new ec2.VpcNetwork(this, 'VPC');

const zone = new route53.PrivateHostedZone(this, 'HostedZone', {
    zoneName: 'fully.qualified.domain.com',
    vpc    // At least one VPC has to be added to a Private Hosted Zone.
});

Additional VPCs can be added with zone.addVPC().

Adding Records

To add a TXT record to your zone:

import route53 = require('@aws-cdk/aws-route53');

new route53.TXTRecord(zone, 'TXTRecord', {
    recordName: '_foo',  // If the name ends with a ".", it will be used as-is;
                         // if it ends with a "." followed by the zone name, a trailing "." will be added automatically;
                         // otherwise, a ".", the zone name, and a trailing "." will be added automatically.
    recordValue: 'Bar!', // Will be quoted for you, and " will be escaped automatically.
    ttl: 90,             // Optional - default is 1800
});

Adding records to existing hosted zones

If you know the ID and Name of a Hosted Zone, you can import it directly:

const zone = HostedZoneRef.import(this, 'MyZone', {
    zoneName: 'example.com',
    hostedZoneId: 'ZOJJZC49E0EPZ',
});

If you don't know the ID of a Hosted Zone, you can use the HostedZoneProvider to discover and import it:

const zone = new HostedZoneProvider(this, {
    domainName: 'example.com'
}).findAndImport(this, 'MyZone');

Changelog

0.17.0 (2018-11-14)

Bug Fixes

• aws-ecs: remove DockerHub constructor class (#1153) (ed14638)
• aws-ec2: add dependency on gateway attachment for public routes (#1142) (15b255c), closes #1140
• s3-deployment: bundle modules correctly (#1154) (0cb1adf)

Features

• aws-codedeploy: add an addToPipeline method to Deployment Group. (#1166) (bdbeb7c)
• aws-codepipeline, aws-cloudformation: support cross-region CloudFormation pipeline action (#1152) (8e701ad)
• toolkit: print available templates when --language is omitted (#1159) (5726c45)

BREAKING CHANGES TO EXPERIMENTAL FEATURES

• aws-ec2: Method signature of VpcPublicSubnet.addDefaultIGWRouteEntry changed in order to add a dependency on gateway attachment completing before creating the public route to the gateway. Instead of passing a gateway ID string, pass in a cloudformation.InternetGatewayResource object and a cloudformation.VPCGatewayAttachmentResource object.
• If you were using DockerHub.image() to reference docker hub images, use ContainerImage.fromDockerHub() instead.